home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / datalist / datalist.exe / %MAINDIR% / readme.txt < prev    next >
Encoding:
Text File  |  1998-03-09  |  16.1 KB  |  445 lines
  1. ==========================================================================
  2.  
  3. Monday, December 12, 1997
  4.                               
  5. DataList(tm)
  6. Version 1.00k Release (Build 45)
  7.  
  8. Copyright (c) 1996-1998 GreenTree Technologies, Inc.
  9.  
  10. Warning:  This product is licensed to you pursuant to the terms of the
  11. license agreement included with the original software, and is
  12. protected by copyright law and international treaties.  Unauthorized
  13. reproduction or distribution may result in severe civil and criminal
  14. penalties, and will be prosecuted to the maximum extent possible under
  15. the law.
  16.  
  17. GreenTree Technologies, Inc.
  18. 33 Walt Whitman Road
  19. Suite 236
  20. Huntington Station, NY 11746   USA
  21.             
  22. Voice: (516) 271-6995
  23. Fax:   (516) 271-8067
  24. Web Site: www.green-tree.com
  25. EMail: info@green-tree.com
  26.                               
  27. ==========================================================================
  28.  
  29. Note #1: If you are using DataList in Microsoft Visual C++ 4.x or later, the
  30. classes generated by ClassWizard for DataList need to be rebuilt if they were
  31. created with an earlier version of DataList.  These classes are defined in the
  32. GTList32.h and GTList32.cpp files by default.
  33.  
  34. Note #2: If you are using the 16-bit version of DataList and the DataList
  35. Designer fails to appear when being invoked, register the gt-ld16.exe file
  36. that can be found in the datalist\bin directory.  To do this, double click
  37. on the file from explorer or file manager.
  38.  
  39. This document contains release notes for DataList. Information in this 
  40. document is more current than that in the manuals or online Help.
  41.  
  42. This README file contains the following topics:
  43.  
  44. Part 1 - Addendum to the Programmer's Guide
  45. -------------------------------------------
  46. Lists errors and/or omissions in the DataList Programmer's Guide.
  47.  
  48. Part 2 - Release History
  49. -------------------------
  50. Changes made made to DataList that need to be noted.
  51.  
  52. Part 3 - About DataList
  53. -------------------------
  54. Description and summary of features of DataList.
  55.  
  56. ==========================================================================
  57.  
  58.  
  59. Part 1 - Addendum to the Programmer's Guide
  60. ======================
  61. 1. The code in Sample3 for GTCombo (Adding ListItems and Sorting) should read:
  62.  
  63.     Dim MyPath As String
  64.     Dim MyName As String
  65.     
  66.     GTList1.ColumnDefs.Add , , "Name"    
  67.     GTList1.ColumnDefs.Add , , "Type"
  68.     
  69.     MyPath = "c:\"  ' Set the path.
  70.     MyName = Dir(MyPath, vbDirectory)   ' Retrieve the first entry.
  71.     
  72.     Do While MyName <> ""   ' Start the loop.
  73.         ' Ignore the current directory and the encompassing directory.
  74.         If MyName <> "." And MyName <> ".." Then
  75.             ' Use bitwise comparison to determine the file type.
  76.             GTList1.AddItem (MyName)
  77.  
  78.         If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
  79.                 GTList1.ListItems(GTList1.NewIndex).SubItems(1) = "Directory"
  80.             ElseIf (GetAttr(MyPath & MyName) And vbNormal) = vbNormal Then
  81.                  GTList1.ListItems(GTList1.NewIndex).SubItems(1) = "File"
  82.             End If  ' get file type.
  83.         End If
  84.         MyName = Dir    ' Get next entry.
  85.     Loop
  86.  
  87.  
  88. Part 2 - Release History
  89. ===========================
  90. Version 1.00k
  91. =============
  92. 1. Inline release to fix problem with text appearing in reverse 
  93.    upon combo box editing.
  94.  
  95. Version 1.00j
  96. =============
  97. 1. Inline release to fix text not appearing in edit portion of GTCombo when
  98.    item is selected in list.
  99.  
  100. Version 1.00i
  101. =============
  102. 1. Bug Id# 21, GTList16 -- GPF when populated > 1200 resolved.    
  103.     
  104. 2. Bug Id# 26, GTList32 -- GPF with multiselect set to extended resolved.    
  105.     
  106. 3. Bug Id# 30, GTCombo32 --    The use of the left and right arrow keys to 
  107.     edit the contents of the combo box (wither virtual or not) causes the 
  108.     focus to shift to the previous and next controls respectively, instead 
  109.     of allowing you to edit the text in the combo box. The Right/Left arrow 
  110.     problem is a limitation of VB since VB subclasses OCXs differently.
  111.  
  112. 4. Bug Id# 45, GTCombo32 -- Mousedown right button now works properly
  113.     
  114. 5. Bug Id# 57, GTList32  -- Xtended Tips now functions    
  115.     
  116. 6. Bug Id# 97, GTCombo16 -- GTCombo now transfers text to text controls    
  117.     
  118. 7. Bug Id# 99, Applies to all controls --Can now set ListIndex in Virtual Mode    
  119.     
  120. 8. Bug Id# 101, GTList16 -- GPF when populate > 2500 with 4 columns resolved.    
  121.     
  122. 9. Bug Id# 196, GTList16 -- GPF when dragging mouse from columnheader to row resolved.    
  123.     
  124. 10. Bug Id# 122, GTCombo32 -- Combostyle GTList disregards Order of events. 
  125.     Explanation:     The Order of Events are never guaranteed between two controls. 
  126.     ie. An event in Control A can happen before or after Control B.  DropDown 
  127.     can fire before the LostFocus of another control.
  128.     
  129. 11. Bug Id# 188, GTList32 -- Scroll Event doesn't fire consistently. Explanation:    
  130.     The VertScroll event means that the control scrolled.  It does not mean 
  131.     "TopIndex Changed".
  132.  
  133.  
  134. Version 1.00h
  135. 1.  Hitting Ctrl or Shift no longer scrolls certain lists.
  136.  
  137. 2.  With statement now works with Collections
  138.  
  139. 3.  Text property on GTList now reflects the current item.
  140.  
  141. 4.  Index/Key misalignment when Removing Items fixed.
  142.  
  143. 5.  Setting TopIndex now makes Scrollbar appear when needed.
  144.  
  145. 6.  KeyStrokes with the AutoPositionList option turned on no longer
  146.     causes a lockup when the focus is set to -1.
  147.  
  148. 7.  Authenticode Signed
  149.  
  150. 8.  Bug Id# 100 Fixed - Changing Datasource now consistently shows all entries.
  151.     
  152. 9.  Bug Id# 102, GTCombo16&32 -- GTCombo no longer requires several clicks 
  153.     ("EATS the Clicks") to dropdown list. 
  154.  
  155. 10. Bug Id# 83, GTList32 -- END key now functions properly; no disappearing list items
  156.     
  157. 11. Bug Id# 113, GTCombo32 -- Setting ListIndex to -1 now functions properly when 
  158.     Combostyle is set to 2.
  159.     
  160.  
  161. Version 1.00g
  162. 1.  Clipping problem with all the text in the controls resolved.
  163.  
  164. 2.  Unbound ComboList not displaying currently selected text fixed.
  165.  
  166. 3.  Sample 7 fixed.  In previous versions, columns would disappear
  167.     when going to/from designer.
  168.  
  169. 4.  VB5 hanging when returning from Designer no longer happens.
  170.  
  171. 5.  SelIndices property now works.
  172.  
  173. 6.  Setting TopIndex in virtual mode now moves the scrollbar to the correct
  174.     place.
  175.  
  176. 7.  Left/Top/Width properties added to SubItem object.
  177.  
  178. 8.  GTCombo capture problem in Visual Basic 5.0 fixed.
  179.  
  180. 9.  Feature Added:  When height of listitem set to 0 and wordwrap is
  181.     on, the row will automatically adjust its height.
  182.  
  183. 10. ForeColor can now be set on virtual listitems in ListItemDataRequest.
  184.  
  185. 11. HitTestItem now works on Virtual ListItems
  186.  
  187. 12. KeyPress changes to the key are now reflected in the combo box.
  188.  
  189. 13. Virtual Selection can now select items when list is scrolled.
  190.  
  191. 14. When sorting list that has item selected, the selection now moves with
  192.     that item to its new location in the list.
  193.  
  194. 15. ClickItem now fires when navigating with the keyboard in Extended Multiselect.
  195.  
  196. 16. Setting the ListIndex to 0 after clearing and reading items now works.
  197.  
  198.  
  199. Version 1.00f
  200. 1.  Hitting Shift-Down Arrow right after loading a multi-select list no
  201.     longer GPFs.
  202.  
  203. 2.  Keys are now updated after the list is sorted.
  204.  
  205. 3.  SelCount is now accurate when control is in Single Select Mode (MultiSelect = 0).
  206.  
  207. 4.  List Designer Scrollbar for Images in the ListImages collection now
  208.     becomes enabled when loading a control with more than 6 images.
  209.  
  210.  
  211. Version 1.00e
  212. 1.  Selection problem when unbound list is scrolled is resolved.
  213.  
  214. 2.  Selection dragging is no longer allowed when Ctrl key is held
  215.     down.  This prevents strange MultiSelect happenings.
  216.  
  217. 3.  SelCount now works.
  218.  
  219. 4.  Click Event is now fired when the spacebar is used to select
  220.     an item.
  221.  
  222. 5.  Setting listindex to -1 now works.
  223.  
  224. 6.  "&&" in text property now works correctly displaying "&".
  225.  
  226. 7.  Add Method on ListItems, ColumnDefs, and SubItems collections
  227.     now accept more types.
  228.  
  229. 8.  Vertical Scrollbar now goes away when items are removed and Scrollbar
  230.     is not needed.
  231.  
  232. 9.  TagVariant containing objects GPF resolved.
  233.  
  234. 10. Problem with ClickItem sending the wrong item when clicking on the
  235.     bottom most item has been fixed.
  236.  
  237. 11. Horizantal scrolling problems resolved.
  238.  
  239. 12. FocusRect now shows when ListIndex is -1 in None-Multiselect modes.
  240.  
  241. 13. Scrolling all the way down and then up one does not GPF anymore.
  242.  
  243. 14. Setting the ListItem.Height property now changes individual row
  244.     heights.
  245.  
  246. 15. ListIndex is now properly set to -1 after the ListItems collection
  247.     is cleared.
  248.  
  249. 16. Setting the ListIndex property to -1 in code no longer causes
  250.     strange scrolling effects.
  251.  
  252. 17. Spacebar no longer toggles a selection on/off in single-select mode.
  253.  
  254. 18. Setting ListIndex property on GTCombo now selects the item into the
  255.     edit portion.
  256.  
  257. 19. Setting ListIndex property now fires Click and ClickItem events.
  258.  
  259. 20. Moving the selection cursor in Simple Select mode now fires clicks.
  260.  
  261. 21. TopBookmark has been added as a property.  It functions in the same way
  262.     as TopIndex except for Bound Lists.
  263.  
  264. 22. Multiselect Keyboard Navigation while holding 'Ctrl' key now is correct.
  265.  
  266. 23. ExtendTips now work on MDI children.
  267.  
  268. 24. GTCombo now selectes items when selection highlight moved using the 
  269.     keyboard.
  270.  
  271. 25. Alt-Down Arrow now drops the combobox down and hides it.
  272.  
  273. 26. DropDownList now shows focus/selection rect when it has focus.  Previously
  274.     there was no way to tell if it had focus.
  275.  
  276. 27. Click/ListItemSelected events now fire in DropDownList.
  277.  
  278. 28. Tab Key now causes dropdown to be hidden.
  279.  
  280. 29. ListItemDataRequest event now uses SubItem properties set in this event.
  281.     For example, if you set the BackColor of a SubItem in this event, now
  282.     it is displayed using that backcolor.
  283.  
  284. 30. SelIndices property has been added to facilitate multiselect in
  285.     Virtual Mode.  This property works just like the SelBookmarks property except
  286.     it returns an index.
  287.  
  288. 31. Virtual Mode ListIndex now defaults to -1 and not 0.
  289.  
  290. 32. Clicking on a Virtual ListItem now does not cause a ListItemDataRequest with
  291.     no SubItems to be fired.  A ListItemDataRequest is still fired, but it has
  292.     the correct number of SubItems.
  293.  
  294. 33. Dragging the mouse over a virtual combo box no longer selects al of the items.
  295.  
  296. 34. TopIndex property now also supported in virtual mode.
  297.  
  298. 35. Setting the DisplayText property when ComboStyle is DropDownList now effects
  299.     the text displayed in the top portion of the control.
  300.  
  301. 36. DataFieldDisplay property now works when using the control in Bound Mode.
  302.  
  303. 37. Resource Leak in VB4 when using the control on a client applications that
  304.     invokes a modal out-of-process server can now be avoided by setting ExtendTips property
  305.     to False.  This is only required in Visual Basic 4 and not in any other
  306.     environment.  This is caused by VB4 not handling controls with timers
  307.     correctly in this situation.  Setting this property to False in previous versions
  308.     did not effect the leak.
  309.  
  310. 38. Problem when setting Scrollbar not disappearing when HorzScrollbar or VertScrollbar
  311.     is set to 0 resolved.
  312.  
  313. 39. Problems with Horizantal scrollbar when there are no items resolved.
  314.  
  315. 40. Combo Autoposition problems resolved.
  316.  
  317. 41. DefOddBackColor and DefOddForeColor now work in virtual mode.
  318.  
  319. 42. Column Positions are now preserved when entering and exiting the List Designer.
  320.  
  321. 43. Scrollbar now updates correctly when adding items to a database that the control
  322.     is bound to.
  323.  
  324. 44. The order in which the SelBookmarks property reports the selected bookmarks is
  325.     now the order in which they were selected.
  326.  
  327. Version 1.00d
  328. 1. ClickItem Event now fires for Virtual Mode and Bound Mode.
  329.  
  330. 2. Selected Property now works for Virtual Mode
  331.  
  332. 3. GTCombo if clicked on when empty no longer GPFs.
  333.  
  334. 4. Note: SelectedItem is Not Supported for Virtual and Bound modes yet.
  335.  
  336. 5. Note: If you are having trouble launching the DataList Designer in 16-bit,
  337.    go to the c:\DataList\bin directory and run gt-ld16.exe.  It will appear as
  338.    if nothing happened when you do this, however, it will actually have
  339.    registered itself.  Try launching the DataList Designer again.
  340.  
  341. Version 1.00c
  342. 1. Bookmark Property added.  This property acts like a ListIndex property
  343.    in bound mode.  This value returned by Bookmark can be passed to the 
  344.    ListItems collection using the following format:
  345.       GTList1.ListItems(GTList1.Bookmark)
  346.  
  347. 2. SelBookmarks Property Array added.  This property array stores all of
  348.    the currently selected bookmarks when the control is bound.  Only GTList
  349.    has this property.  The syntax for using this property is as follows:
  350.       GTList1.ListItems(GTList1.SelBookmarks(1)).SubItems(1).Text
  351.    This code will access the text in the second collumn of the row that
  352.    was selected second by the user.
  353.  
  354. 3. The Selected Property of the ListItem object can now be used to set the
  355.    selection state of a bound row.  The syntax is as follows:
  356.       GTList1.ListItems(GTList1.Bookmark).Selected = True
  357.  
  358. 4. A new option has been added to the MultiSelect property - 3 - Extended
  359.    (No Negative Selection).  This is to be used when it is required for the
  360.    SelBookmarks Property Array needs to be valid.  If this property is set
  361.    to 2 - Extended, the values in the SelBookmarks may be those that are not
  362.    selected.  For example, in a list with 50 items, the user hit Ctrl-/ which
  363.    selects the entire list and then clicks on the third item.  In this state,
  364.    SelBookmarks will contain only one item and SelCount will be 49.
  365.  
  366. Note: See Readme2.Wri with documentation on Bookmark and SelBookmarks Properties.
  367.  
  368. Version 1.00b
  369. 1. ListItems.Clear when VirtualCount is set GPF is fixed.
  370.  
  371. 2. Control Enumeration problems (ComCtl32.dll Property Page GPF) is fixed.
  372.  
  373. 3. ListIndex may now be set to -1;
  374.  
  375. 4. Virtual ListIndex now work for set and get.
  376.  
  377. 5. Samples have been fixed.
  378.  
  379. 6. Clicking on Blank Line in Combo GPF fixed.
  380.  
  381. 7. Extra BlankLines at bottom of Combo in AddItem Mode removed.
  382.  
  383. 8. AddItem Mode Drag Selection in Combo problems fixed.
  384.  
  385. 9. SelCount now gets reset when ListItems collection is cleared.
  386.  
  387. 10. Changes made in the DropDown Event now take effect right away.
  388.  
  389. 11. Binding to RDC now retrieves all the fields in a database.
  390.  
  391. 12. Initial Virtual Selection State Fixed
  392.  
  393.  
  394. Version 1.00a
  395. 1. Incorrect SubItemSouce default values causing data not to show in
  396.    correct columns in multicolumn GTList and GTCombo fixed.
  397.  
  398. 2. Icons for Samples now have correct path.
  399.  
  400. Verison 1.00 - Final 8/16/96
  401.  
  402.  
  403. Part 3 - About DataList
  404. ===========================
  405.  
  406. The GTList(tm) Control is a 16/32 bit OLE Control that provides a
  407. superset of functionality based on a standard Listbox Control.  Many
  408. features have been added along with data binding and multi-column support.
  409.  
  410. GTList Control
  411. 1.  Can be bound to any data source.
  412. 2.  Either bound or unbound, the amount of data is unlimited, breaking
  413.     the 64k barrier.
  414. 3.  Supports multiple columns.
  415. 4.  Each item and column header can have a different forecolor, backcolor,
  416.     alignment, font, picture, etc.  These properties can be defined for
  417.     each Item or each Column.
  418. 5.  Columns can be moved or resized by end-user via drag and drop.
  419. 6.  Multiline rows supported.
  420. 7.  Simple and extended multiselect.
  421. 8.  ScrollTips(tm) display data as the user scrolls.
  422. 9.  Tooltips are used to display data not completely visible.
  423. 10.  List items can be entered at design time.
  424. 11.  List Designer allows you to customize the look of the list at design
  425.      time.
  426. 12.  Supports ImageList control.
  427.  
  428. The GTCombo(tm) Control is a 16/32 bit OLE Control that provides a superset
  429. of functionality based on a standard Combobox Control.  Many features have
  430. been added along with data binding and multi-column support.
  431.  
  432. GTCombo Control
  433. 1.  GTCombo Control displays a drop-down GTList.
  434. 2.  The list portion of GTCombo has all the same formatting capabilities
  435.     as the GTList Control.
  436. 3.  All standard combobox styles are supported.
  437. 4.  Width of drop-down portion can be different than the edit portion.
  438. 5.  Data binding is supported for the list portion and also the edit
  439.     portion.
  440. 6.  Supports same formatting and functional capabilities as GTList Control.
  441.  
  442.  
  443.  
  444.  
  445.